'\" t
.\"     Title: drbdadm
.\"    Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 6 May 2011
.\"    Manual: システム管理
.\"    Source: DRBD 8.4.0
.\"  Language: English
.\"
.TH "DRBDADM" "8" "6 May 2011" "DRBD 8.4.0" "システム管理"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
drbdadm \- DRBD の高レベル管理ツール
.SH "SYNOPSIS"
.HP \w'\fBdrbdadm\fR\ 'u
\fBdrbdadm\fR [\-d] [\-c\ {\fIfile\fR}] [\-t\ {\fIfile\fR}] [\-s\ {\fIcmd\fR}] [\-m\ {\fIcmd\fR}] [\-S] [\-h\ {\fIhost\fR}] [\-\-\ {\fIbackend\-options\fR}] {\fIcommand\fR} [{all} | {\fIresource\fR\fI[/volume>]\fR...}]
.SH "DESCRIPTION"
.PP
\fBDrbdadm\fR
は DRBD プログラム群の中で高レベルの管理ツールである。\fBDrbdadm\fR
は
\fBdrbdsetup\fR
と
\fBdrbdmeta\fR
の上位レベルのインタフェースである。これは、\fBifconfig\fR
の
\fBifup\fR/\fBifdown\fR
コマンドに対する関係と同様である。\fBDrbdadm\fR
は設定ファイルを読み込んで、
\fBdrbdsetup\fR
や
\fBdrbdmeta\fR
を呼び出してコマンドを実行する。
.PP
\fBDrbdadm\fR
は全リソース、リソース中のボリュームに対して操作が行える。サブコマンドには次のものがある。
\fBattach\fR,
\fBdetach\fR,
\fBprimary\fR,
\fBsecondary\fR,
\fBinvalidate\fR,
\fBinvalidate\-remote\fR,
\fBoutdate\fR,
\fBresize\fR,
\fBverify\fR,
\fBpause\-sync\fR,
\fBresume\-sync\fR,
\fBrole\fR,
\fBcsytate\fR,
\fBdstate\fR,
\fBcreate\-md\fR,
\fBshow\-gi\fR,
\fBget\-gi\fR,
\fBdump\-md\fR,
\fBwipe\-md\fR
。これらは全リソースとボリュームに対して機能する。
.PP
リソースレベルのみのコマンドには次のものである。
\fBconnect\fR,
\fBdisconnect\fR,
\fBup\fR,
\fBdown\fR,
\fBwait\-connect\fR
and
\fBdump\fR。
.SH "OPTIONS"
.PP
\fB\-d\fR, \fB\-\-dry\-run\fR
.RS 4
実行する
\fBdrbdsetup\fR
コマンドを標準出力に書き出すが、実際にコマンドは実行しない。
.RE
.PP
\fB\-c\fR, \fB\-\-config\-file\fR \fIfile\fR
.RS 4
drbdadm が使う設定ファイルを指定する。このパラメータを省略すると、
\fB/etc/drbd\-84\&.conf\fR,
\fB/etc/drbd\-83\&.conf\fR,
\fB/etc/drbd\-08\&.conf\fR,
\fB/etc/drbd\&.conf\fR
が参照される。
.RE
.PP
\fB\-t\fR, \fB\-\-config\-to\-test\fR \fIfile\fR
.RS 4
drbdadm にチェックさせる設定ファイルを指定する。dump コマンドまたは sh\-nop コマンドと共に使用する場合のみ有効である。
.RE
.PP
\fB\-s\fR, \fB\-\-drbdsetup\fR \fIfile\fR
.RS 4
\fBdrbdsetup\fR
プログラムのフルパスを指定する。省略すると、自身のコマンド配置場所配下と、$PATH が参照される。
.RE
.PP
\fB\-m\fR, \fB\-\-drbdmeta\fR \fIfile\fR
.RS 4
\fBdrbdmeta\fR
プログラムのフルパスを指定する。省略すると、自身のコマンド配置場所配下と、$PATH が参照される。
.RE
.PP
\fB\-S\fR, \fB\-\-stacked\fR
.RS 4
積み重ねた上位リソースに対する操作を指示する場合に指定する。
.RE
.PP
\fB\-P\fR, \fB\-\-peer\fR
.RS 4
どの対向ノードと接続するかを指定する。リソースの定義に3台以上のホストを指定した場合にのみ必要である。
.RE
.PP
\fB\-\-\fR \fIbackend\-options\fR
.RS 4
二重ハイフンの後に続くオプションはすべて
\fIbackend\-options\fR
として認識される。これらはバックエンドコマンドに渡される。つまり
\fBdrbdsetup\fR、\fBdrbdmeta\fR、\fBdrbd\-proxy\-ctl\fR
などに渡される。
.RE
.SH "COMMANDS"
.PP
attach
.RS 4
DRBD リソースに対応する低レベルのローカルブロックデバイスを接続する。
.RE
.PP
detach
.RS 4
DRBD リソースデバイスから下位ストレージデバイスを切り離す。
.RE
.PP
connect
.RS 4
リソースデバイスに対するネットワーク設定を有効にする。対応する接続先がすでに設定されていれば、2 台の DRBD デバイスは相互に接続される。リソース定義中に 3 台以上のホストを指定してある場合、接続先ホストを指定するために
\fB\-\-peer\fR
も指定する必要がある。
.RE
.PP
disconnect
.RS 4
リソースに対するネットワーク設定を無効にする。デバイスは当然ながらスタンドアローン状態になる。
.RE
.PP
syncer
.RS 4
デバイスの再同期に関するパラメータを読み込む。
.RE
.PP
up
.RS 4
attach と connect の両方を実行するショートカット。
.RE
.PP
down
.RS 4
attach と connect の両方を実行するショートカット。
.RE
.PP
primary
.RS 4
リソースのデバイスをプライマリ状態に昇格する。DRBD が管理するデバイスにファイルシステムを作成したりそれをマウントする前に、必ずこのコマンドを実行する必要がある。
.RE
.PP
secondary
.RS 4
デバイスをセカンダリ状態に切り替える。接続された DRBD デバイスペアのどちらか一方しかプライマリ状態になれないので、このコマンドが必要である(設定ファイル中に
\fBallow\-two\-primaries\fR
が明示的に指定されている場合を除く)。
.RE
.PP
invalidate
.RS 4
\fIローカル\fR下位デバイスが不整合になったと DRBD に判断させる。したがって、両デバイスが同期状態になるよう、DRBD はすべてのブロックを他方のノードからコピーする。このとき、レプリケーションリンクを確率させておく必要があり、そうでないと disconnected Secondary の状態になる。
.RE
.PP
invalidate\-remote
.RS 4
invalidate コマンドに似ているが、\fI対向\fRノードの下位デバイスが非同期状態になったとみなす。したがって、ローカルノードのデータが他ノードにコピーされる。このとき、レプリケーションリンクを確率させておく必要があり、そうでないと disconnected Primary の状態になる。
.RE
.PP
resize
.RS 4
DRBD にディスクサイズ関連の状態を再評価させ、必要ならデバイスのサイズを変更する。例えば両ノードで下位デバイスのサイズを拡張した場合には、どちらか一方のノードでこのコマンドを実行した後で、DRBD は新しいサイズを受け入れる。新しいストレージ領域は同期される必要があるため、最低でも 1 つのプライマリノードが存在する場合にのみ、このコマンドは機能する。
.sp
以下のオプションはすべて
\fBbackend\-options\fR
である ("\-\-" で分離される)。
.sp
\fB\-\-size\fR
オプションは DRBD デバイスで使用できるサイズのオンライン縮小に使用される。ファイルシステムがこの操作によって破損しないことはユーザ責任において確認する。例:
.sp
.if n \{\
.RS 4
.\}
.nf
# drbdadm \-\- \-\-size=10G resize r0
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-assume\-peer\-has\-space\fR
オプションは、現在対向ノードに接続されていないデバイスのサイズ変更ができる。対向ノードのディスクサイズを同様に変更しないと、以降接続が失敗するので注意すること。
.sp
\fB\-\-assume\-clean\fR
オプションは、既存のデバイスのサイズを変更し、新しい領域の同期を回避できる。空のストレージをデバイスに追加する場合に有用である。例:
.sp
.if n \{\
.RS 4
.\}
.nf
# drbdadm \-\- \-\-assume\-clean resize r0
.fi
.if n \{\
.RE
.\}
.sp
\fB\-\-al\-stripes\fR
と
\fB\-\-al\-stripe\-size\-kB\fR
オプションはオンラインでアクティビティログのレイアウトを変更する。内部メタデータの場合には、同時に、下位デバイスのユーザーに見えるサイズ(\fB\-\-size\fR
を使用して)の縮小、または拡大が必要である。
.RE
.PP
check\-resize
.RS 4
内部メタデータの移動のために drbdmeta を呼び出す。DRBD の停止中に下位デバイスのサイズが変更された場合、次回の
\fBattach\fR
コマンドが成功するように、メタデータをデバイスの最後に移動する必要がある。
.RE
.PP
create\-md
.RS 4
メタデータ領域を初期化する。DRBD リソースを初めて利用する場合、オンラインにする前にこのコマンドを実行する必要がある。問題が起きた場合には、次のマニュアルを参照：\fBdrbdmeta\fR(8)
.RE
.PP
get\-gi
.RS 4
データ世代識別子の情報を簡潔なテキスト情報として表示する。
.RE
.PP
show\-gi
.RS 4
データ世代識別子の情報を、説明テキストとともにテキスト情報として表示する。
.RE
.PP
dump\-md
.RS 4
メタデータの全内容をテキスト形式でダンプする。ダンプにはビットマップとアクティビティログも含まれる。
.RE
.PP
outdate
.RS 4
メタデータに outdated フラグをたてる。
.RE
.PP
adjust
.RS 4
設定ファイルの設定値にしたがってデバイスの設定状態を調整する。実際に実行する前に、あらかじめ dry\-run モードを実行して、得られた出力を吟味すべきである。
.RE
.PP
wait\-connect
.RS 4
他ノードのデバイスと接続するまで待機する。
.RE
.PP
role
.RS 4
自機および対向ノードのデバイスの現在の役割を "自機/対向ノード" の形式で表示する。例、 Primary/Secondary
.RE
.PP
state
.RS 4
廃止された "role" の別名。前項を参照。
.RE
.PP
cstate
.RS 4
両ノードのデバイスの接続状態を表示する。
.RE
.PP
dump
.RS 4
設定ファイルを解析して標準出力に出力する。設定ファイルの構文上の修正を行うときに有用である。
.RE
.PP
outdate
.RS 4
ノードのデータ状態を outdated(無効) にする。通常は、他ノードの fence\-peer ハンドラによってセットされる。
.RE
.PP
verify
.RS 4
オンライン照合を開始する。両ノードのデータが比較され、不整合がないか検査される。進行状況は
/proc/drbd
に表示される。非同期ブロックが見つかった場合でも、再同期は\fI自動的には行われない\fR。同期するには、検査の終了後に
\fBdisconnect\fR
してから
\fBconnect\fR
する。
.sp
drbd\&.conf マニュアルページのデータ整合性に関する説明も参照のこと。
.RE
.PP
pause\-sync
.RS 4
ローカルメタデータの一時停止フラグをセットして、進行中の再同期を一時停止する。再開させるには、ローカルと他ノードの両方の一時停止フラグをクリアする必要がある。下位デバイスの RAID を再構成している場合などに、一時的に DRBD の再同期を停止できる。
.RE
.PP
resume\-sync
.RS 4
自機の一時停止フラグをクリアする。
.RE
.PP
new\-current\-uuid
.RS 4
新しいカレント UUID を生成し、他のすべての UUID をローテートする。
.sp
初期同期時間を短縮するためにこのコマンドを利用できる。詳細については
\fBdrbdsetup\fR
マニュアルページを参照。
.RE
.PP
dstate
.RS 4
下位デバイスの同期状況を表示する。(local/peer)
.RE
.PP
hidden\-commands
.RS 4
このマニュアルに記載されていない全部のコマンドを表示する。
.RE
.SH "VERSION"
.sp
このドキュメントは DRBD バージョン 8\&.4\&.0 向けに改訂されている。
.SH "AUTHOR"
.sp
Written by Philipp Reisner <philipp\&.reisner@linbit\&.com> and Lars Ellenberg <lars\&.ellenberg@linbit\&.com>
.SH "REPORTING BUGS"
.sp
Report bugs to <drbd\-user@lists\&.linbit\&.com>\&.
.SH "COPYRIGHT"
.sp
Copyright 2001\-2011 LINBIT Information Technologies, Philipp Reisner, Lars Ellenberg\&. This is free software; see the source for copying conditions\&. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE\&.
.SH "SEE ALSO"
.PP
\fBdrbd.conf\fR(5),
\fBdrbd\fR(8),
\fBdrbddisk\fR(8),
\fBdrbdsetup\fR(8),
\fBdrbdmeta\fR(8)
and the
\m[blue]\fBDRBD project web site\fR\m[]\&\s-2\u[1]\d\s+2
.SH "NOTES"
.IP " 1." 4
DRBD project web
site
.RS 4
\%http://www.drbd.org/
.RE
